Skip to content

feat(comms): per-user chat inbox category (priority / general) - #1037

Open
dylanjeffers wants to merge 1 commit into
mainfrom
feat/chat-inbox-category
Open

feat(comms): per-user chat inbox category (priority / general)#1037
dylanjeffers wants to merge 1 commit into
mainfrom
feat/chat-inbox-category

Conversation

@dylanjeffers

@dylanjeffers dylanjeffers commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Summary

Backend for the Priority / General inbox split in the clients. Users can file each direct-message chat into a Priority or General inbox; the choice is private to that user and persists so future messages route to the right tab. A chat with no preference row is uncategorized.

Changes

  • Migration 0240_user_conversation_preferences.sql: user_conversation_preferences (user_id, chat_id, category CHECK IN ('priority','general'), updated_at), PK (user_id, chat_id). Idempotent, wrapped in a transaction.
  • RPC chat.set_category { chat_id, category: "priority" | "general" | null }: validator checks chat membership and the enum; apply upserts with the RPC timestamp guard (same idiom as chat_permissions), and null deletes the row. New ChatCategory enum and Category param in schema.go.
  • GET /comms/chats and GET /comms/chats/:chatId now return "category" per chat (null for uncategorized and for blast pseudo-chats). Both queries LEFT JOIN the new table; the members subquery was re-aliased to avoid ambiguity.
  • GET /comms/chats/unread_by_category: { priority, general, uncategorized } counts of chats with unread_count > 0, mirroring /comms/chats/unread's filter. All three keys are always present.
  • sql/01_schema.sql / sql/03_migration_tracker.sql re-dumped via make test-schema. This also picks up drift from 0238/0239 (which were never re-dumped) and a pg_dump header version bump from the local image.

clear_user_records only exists in the frozen schema dump, so it does not yet delete from the new table; that needs a separate function migration if wanted.

Companion PR

Client side (SDK, store, web and mobile tab UI): AudiusProject/apps#14593. Deploy this first; older clients ignore the new field, and the new client falls back gracefully if the endpoint is missing.

Test plan

  • go build ./..., go vet clean, gofmt clean on changed files
  • go test ./api/comms/... (new TestChatSetCategory: validator accept/reject, apply, timestamp guards, clear)
  • go test ./api/... (new TestPostMutateChatSetCategory round trip through /comms/mutate asserting category on both GET endpoints and per-user isolation; new TestGetUnreadCountByCategory)
  • Stage: run migration, set a category from the client, confirm category and unread_by_category responses

🤖 Generated with Claude Code

Backs the Priority / General inbox split in the clients. Each user can
file a direct-message chat into a "priority" or "general" inbox; the
choice is private to that user and a chat with no row is uncategorized.

- Migration 0240 adds `user_conversation_preferences`
  (user_id, chat_id, category, updated_at), PK (user_id, chat_id).
- New RPC `chat.set_category` { chat_id, category | null }. Validation
  checks membership and the enum; writes are guarded by the RPC
  timestamp like chat_permissions so a late RPC can't clobber newer state;
  null deletes the row.
- `GET /comms/chats` and `GET /comms/chats/:id` return `category` per chat
  (null for uncategorized and blasts).
- New `GET /comms/chats/unread_by_category` returns unread-chat counts
  split into priority / general / uncategorized, mirroring
  `/comms/chats/unread`'s filter.
- sql/01_schema.sql and sql/03_migration_tracker.sql re-dumped via
  `make test-schema` (also picks up previously un-dumped 0238/0239).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant